home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / es_101d.zip / ES.DOC < prev    next >
Text File  |  1992-08-01  |  104KB  |  3,242 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   ╦                        ■      ╦
  9.           ╔═╗ ╔═╗ ╠══╗ ╔══╗  ╔══ ╔══╗ ╗╔═╗ ╦ ╗╔═╗ ╠═╣
  10.           ╠═╝ ║   ║  ║ ║  ║  ╚═╗ ║  ║ ╠╝   ║ ╠╝ ║ ║
  11.           ╚══ ╚═╝ ╩  ╩ ╚══╝  ══╝ ╠══╝ ╩    ╩ ╩  ╩ ╚═╝  version 1.01
  12.                                  ╩
  13.  
  14.           A dynamic mail transmission system for Advanced Engineering's
  15.           FrontDoor package and other FidoNet front-end mailers
  16.  
  17.  
  18.  
  19.  
  20.           User's Guide
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.           (C) 1991, 1992, Compact Solutions.  All rights reserved.
  49.  
  50.           Software development:  B. J. Elliston
  51.                                  M. W. Hulskamp
  52.  
  53.           Documentation:         B. J. Elliston
  54.  
  55.                                       - 1 -
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                   Chapter 1
  64.  
  65.                                    PREFACE
  66.  
  67.  
  68.           1.1  Introduction
  69.  
  70.           Welcome to the state of the art in mail transfers!
  71.  
  72.           EchoSprint has been developed to satisfy the needs of the world's
  73.           many system operators active in amateur mail networks and who use
  74.           electronic mailers (and specifically, users of Advanced
  75.           Engineering's FrontDoor package).  Many of these operators are
  76.           obligated to use the transfer protocols which are written into
  77.           their mailers.  This may be satisfactory, but other stand-alone
  78.           protocols exist which may add reliability, speed and other
  79.           benefits to your transfers.
  80.  
  81.           EchoSprint is a file transfer engine for files and mail using
  82.           FidoNet compliant mailers and allows a number of useful
  83.           additional features to be implemented.
  84.  
  85.           Using a compatible protocol, this broadens the potential for
  86.           front-end mailers enormously.  Transfers can now be conducted
  87.           more swiftly, with more reliability and perhaps include chatting
  88.           capabilities during the session.  One known protocol even allows
  89.           simple games to be played with the remote system during
  90.           a session!
  91.  
  92.           1.2  Features
  93.  
  94.           EchoSprint is designed, like packages such as TosScan, to
  95.           interface directly with FrontDoor.  During early development of
  96.           EchoSprint, it was envisaged that the package would be targeted
  97.           at FrontDoor users, but it has since been realised that many
  98.           other mailers satisfy the fundamental requirements for EchoSprint
  99.           to operate.  Such known mailers are BinkleyTerm, D'Bridge and
  100.           InterMail.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.                                       - 2 -
  110.  
  111.           Much of EchoSprint's operation can be controlled from the
  112.           FrontDoor Setup program.  A handful of other options must be
  113.           defined in EchoSprint's own configuration editor, since their
  114.           nature is not common to FrontDoor.  If you do not use FrontDoor,
  115.           these configuration files will still need to be created.  Please
  116.           see Chapter 10 for further details.
  117.  
  118.           EchoSprint is a mailer invoked by the front-end when the system
  119.           receives an external mail string.  The calling system is actually
  120.           another mailer running EchoSprint in an external event whose
  121.           behaviour is identical to a mail event.  Once EchoSprint is
  122.           loaded on the answering system, a proprietary "G2U" handshake
  123.           is initiated.
  124.  
  125.           Event behaviour, general system behaviour and mail routing are
  126.           all extracted from your existing FrontDoor configuration.  In
  127.           other words, human callers and non-G2U mailers will all be
  128.           treated usually.  EchoSprint is completely transparent!
  129.  
  130.           EchoSprint has been designed to improve on the functionality of
  131.           current front-end mailers.  The main features are described
  132.           briefly below:
  133.  
  134.           o  Support for an unlimited number of external protocols
  135.              including bidirectional protocols.  Use of efficient protocols
  136.              may aid in reducing large feed systems' phone bills by up to
  137.              40% or more.
  138.  
  139.           o  Full zone, point and AKA support.
  140.  
  141.           o  An in-built file request engine exists for file requests.  The
  142.              system allows use of a failure message through the use of a
  143.              template, similar to that used by BinkleyTerm or a FrontDoor
  144.              style message (optionally adding additional text).  In either
  145.              case, specifications (such as maximum transfer time) are
  146.              followed from the FrontDoor configuration.
  147.  
  148.           o  File attaches will be sent, too, but must be created in *.MSG
  149.              format.  EchoSprint does not support the temporary packets
  150.              created by FrontDoor, but still works fine without them.
  151.              Using the <Alt-T> keypress  on FrontDoor's mailer screen, for
  152.              example, is generally unusable for creating file attaches
  153.              anyway, because if the mailer exits prematurely, the temporary
  154.              file attach is removed.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.                                       - 3 -
  164.  
  165.           o  If ARCmail is received during the session, then EchoSprint
  166.              will exit when complete using the errorlevel prescribed in
  167.              FrontDoor's Setup program, for running your conference mail
  168.              processor, such as TosScan or Squish.
  169.  
  170.           o  Several other error conditions and errorlevels exist, but are
  171.              dealt with in EchoSprint's Setup program and are definable to
  172.              suit your batch file and to perform operations based on
  173.              error conditions similar to FrontDoor.
  174.  
  175.           o  To make installation even simpler, EchoSprint returns
  176.              errorlevels identical to FrontDoor's internal errorlevels, in
  177.              the case of internal errors.
  178.  
  179.           1.3  Using this User's Guide
  180.  
  181.           The EchoSprint package is by no means necessarily a simple
  182.           package to install.  Depending on your existing setup and the
  183.           complexity of your network operation, EchoSprint is potentially a
  184.           configuration giant.
  185.  
  186.           This User's Guide is aimed at reducing the time taken to convert
  187.           some or all of your network communication.  It is laid out in a
  188.           front-to-back order, which, if you follow systematically, will
  189.           usually have your new system running in under one hour.
  190.  
  191.           Throughout the User's Guide, a number of conventions are
  192.           established.  Information listed in point form is done so using a
  193.           bullet ("o").  Actions to be conducted with another program (such
  194.           as FrontDoor's configuration editor), are preceded by a greater
  195.           than symbol (">").
  196.  
  197.           The User's Guide is written as simply as possible, acknowledging
  198.           the degree of comprehensiveness required to ensure that
  199.           configuration is a smooth operation.  If you find you get stuck
  200.           at any particular place throughout this User's Guide, it is
  201.           highly suggested that you re-read that particular section until
  202.           you understand what is being said.  Only at that stage should you
  203.           proceed.
  204.  
  205.           1.4  Licence agreement
  206.  
  207.           This software is protected by both Australian copyright law and
  208.           international treaty provisions.  You must treat this software
  209.           just like a book, except that you may copy it onto a computer to
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.                                       - 4 -
  218.  
  219.           be used and you may make archival copies of the software for the
  220.           sole purpose of backing up our software and protecting your
  221.           investment from loss.
  222.  
  223.           By saying "just like a book", Compact Solutions means, for
  224.           example, that this software may be used by any number of people,
  225.           and may be freely moved from one computer location to another, so
  226.           long as there is no possibility of it being used at one location
  227.           or on one computer while it is being used at another.  Just like
  228.           a book cannot be read by two different people in two different
  229.           places at the same time, neither can the software be used by two
  230.           different people in two different places at the same time
  231.           (unless, of course, Compact Solutions' copyright has being
  232.           violated).
  233.  
  234.           Compact Solutions specifically disclaims all other warranties,
  235.           expressed or implied, including but not limited to implied
  236.           warranties of merchantability and fitness for a particular
  237.           purpose with respect to defects in the diskette and
  238.           documentation, and the program licence granted herein in
  239.           particular, and without limiting operation of the program licence
  240.           with respect to any particular application, use, or purpose.
  241.  
  242.           In no event shall Compact Solutions be liable for any loss of
  243.           profit or any other commercial damage, including but not limited
  244.           to special, incidental, consequential or other damages.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                       - 5 -
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.                                   Chapter 2
  280.  
  281.                                  INSTALLATION
  282.  
  283.  
  284.           It is assumed that you are already using the FrontDoor e-mail
  285.           system by Advanced Engineering.
  286.  
  287.           It is possible to run EchoSprint with other mailers, providing
  288.           the mailer features the concept of "external mail strings", where
  289.           the mailer will exit upon receipt of a variable string.  Other
  290.           known mailers to work with EchoSprint include BinkleyTerm,
  291.           D'Bridge and InterMail.  If a mailer other than FrontDoor is
  292.           used, see Chapter 10 for further information before proceeding
  293.           with Chapter 2 and onwards.
  294.  
  295.           Regardless of the mailer being used, you should have an active
  296.           environment variable named "FD" pointing to your FrontDoor system
  297.           directory) and within that directory, have the files SETUP.FD,
  298.           EVENT.FD, ROUTE.FD and possibly some additional *.FD files such
  299.           as PASSWORD.FD or REQUEST.FD.
  300.  
  301.           2.1  Hardware and software requirements
  302.  
  303.           EchoSprint has hardware requirements identical to FrontDoor.  In
  304.           short, if FrontDoor runs on your system, EchoSprint will run also.
  305.  
  306.           To be precise, however, EchoSprint requires:
  307.  
  308.           o  Approximately 75KB of RAM.  If EchoSprint runs in the same
  309.              batch file as FrontDoor, EchoSprint can safely be run under
  310.              multitaskers without the need to make any modifications to
  311.              program information files (PIFs), etc.
  312.  
  313.           o  Approximately 150K of disk space (including online
  314.              documentation).
  315.  
  316.           o  A Hayes compatible modem with available DTR line, if you have
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                       - 6 -
  326.  
  327.              configured FrontDoor to control the state of DTR.
  328.  
  329.           o  An XT- or AT-type keyboard.
  330.  
  331.           o  Any IBM compatible graphics adapter.
  332.  
  333.           o  Monochrome or colour monitor.
  334.  
  335.           2.2  Operating system requirements
  336.  
  337.           EchoSprint requires that certain conditions be set within the
  338.           environment in which it will be operating.  They are controlled
  339.           with the two common operating system files, CONFIG.SYS and
  340.           AUTOEXEC.BAT.
  341.  
  342.           >  CONFIG.SYS
  343.  
  344.           You should have the following lines in your CONFIG.SYS file:
  345.  
  346.           FILES=30
  347.  
  348.           (or higher, if you are running under a multitasker)
  349.  
  350.           BUFFERS=30
  351.  
  352.           If you are using a disk cache, such as SMARTdrive or HyperDisk,
  353.           set BUFFERS to about 5.
  354.  
  355.           >  AUTOEXEC.BAT
  356.  
  357.           The following line should be placed in your AUTOEXEC.BAT file:
  358.  
  359.           SET ES=C:\ES
  360.  
  361.           C:\ES is the directory where the EchoSprint package will be
  362.           located on your hard disk.  This depends on your configuration,
  363.           so adjust this depending on where you will place the EchoSprint
  364.           package.
  365.  
  366.           EchoSprint requires that this environment variable ("ES") is set
  367.           before it will even operate (including the configuration editor),
  368.           to avoid failure in later execution of the software.
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.                                       - 7 -
  380.  
  381.           2.3  Environment variables
  382.  
  383.           After you use the SET command, DOS might display the following
  384.           message:
  385.  
  386.           Out of environment space
  387.  
  388.           This message means that the available environment space is
  389.           insufficient to hold the new variable definition.  For
  390.           information about how to increase the environment space, refer to
  391.           your DOS manual (and in particular, the command line switches for
  392.           COMMAND.COM).
  393.  
  394.           2.4  The distribution archive
  395.  
  396.           EchoSprint has been provided to you within an archive called
  397.           ES_101x.EXE.  It has been created using ARJ version 2.21 and
  398.           contains an archive banner.
  399.  
  400.           Depending on which "flavour" of version 1.01 you have, the
  401.           archive may be named:
  402.  
  403.           ES_101B.EXE    (for closed beta testing)
  404.  
  405.           ES_101D.EXE    (freely distributable demonstration version)
  406.  
  407.           ES_101L.EXE    (licenced version for registered users)
  408.  
  409.           This User's Guide is aimed at users of all these versions.  The
  410.           additional release notes (contained in READ_ME.ES) provide
  411.           information relevant only to the various "flavours" of version
  412.           1.01.
  413.  
  414.           If the archive banner is not present when extracting the files
  415.           from the archive, then your distribution archive has been
  416.           modified and should not be used.  If this is the case, contact
  417.           the authors as detailed in Appendix D for an authentic archive.
  418.           Refer to Appendix F for further information on verifying the
  419.           authenticity of your installation of EchoSprint.
  420.  
  421.           When decompressing the archive, place it in its own empty,
  422.           temporary directory and extract the files by executing the
  423.           archive.  These files will be kept in this directory until
  424.           installation is complete.  At this stage, copy the archive to a
  425.           safe directory for backup.  You may now delete the archive in the
  426.           temporary directory - it is no longer required.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                                       - 8 -
  434.  
  435.           2.5  Directories
  436.  
  437.           EchoSprint needs only one directory in which to store its
  438.           executable and configuration files.  Of course, you may leave a
  439.           copy of the documentation in that directory also, if you wish.
  440.  
  441.           When setting the environment variable in your AUTOEXEC.BAT, you
  442.           should have decided where your EchoSprint directory will be
  443.           located.  Create any directories and sub-directories as
  444.           necessary.
  445.  
  446.           2.6  EchoSprint files
  447.  
  448.           Now that you have an EchoSprint directory, make it the active
  449.           directory and copy the files listed below, as required, from the
  450.           temporary directory where you decompressed the distribution
  451.           archive.
  452.  
  453.           2.6.1  Executable files
  454.  
  455.           ES.EXE is the core of the EchoSprint package.  This is the file
  456.           transfer and mailer system, configuration editor, template
  457.           verifier, documentation reader and nodelist compiler all-in-one.
  458.           Naturally, this file is required in the EchoSprint directory.
  459.  
  460.           2.6.2  Documentation files
  461.  
  462.           Once it has been printed, you may not wish to keep this document
  463.           (ES.DOC) online.  If you do keep it online, you will be able to
  464.           quickly reference the User's Guide from within the manual reader.
  465.           This is a worthwhile venture, especially until you are familiar
  466.           with the package.  The User's Guide file (ES.DOC) is expected to
  467.           be located in the EchoSprint directory.
  468.  
  469.           And, if you so desire, READ_ME.ES (final release information) may
  470.           also be copied to the EchoSprint directory.
  471.  
  472.           The two documentation files mentioned above (ES.DOC and
  473.           READ_ME.ES) are formatted for printing on DOS compatible printers
  474.           supporting 8-bit ASCII and 66 line pages.  To output these files
  475.           to a printer, type:
  476.  
  477.           COPY ES.DOC PRN or COPY READ_ME.ES PRN (depending on which file
  478.           you wish to output to the printer).
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                                       - 9 -
  488.  
  489.           2.6.3  Configuration files
  490.  
  491.           If you will be using the programmable file request failure
  492.           template (similar to that used by BinkleyTerm), copy FREQFAIL.TPL
  493.           to the EchoSprint directory.  You can modify this file to suit
  494.           your own tastes.  See section 3.2.4.3.1 for further details on
  495.           customisation of this template.
  496.  
  497.           EchoSprint stores its only other configuration data in a file
  498.           called SETUP.ES in the EchoSprint directory.
  499.  
  500.           By deleting SETUP.ES, you will force EchoSprint to recreate this
  501.           file during your next configuration session.  In this session,
  502.           the default settings will be placed in the renewed setup file.
  503.  
  504.           2.7  Protocols
  505.  
  506.           EchoSprint does its mail transfers using any number of external
  507.           protocols of your choice.  Naturally, the benefit of this is that
  508.           other protocols may be used instead of the standard protocols
  509.           written into your mailer.  Such protocols may provide superior
  510.           transfer speeds, error correction, data encryption - even
  511.           interactive chatting facilities.
  512.  
  513.           EchoSprint has been tested with a number of protocols, however,
  514.           the most useful seen to date have been BiModem, HS/Link and
  515.           SuperZmodem.
  516.  
  517.           Regardless of the protocol(s) you choose to use, you should
  518.           install these protocols in a directory and be correctly
  519.           configured for use with your system.  Refer to Chapter 8 for
  520.           detailed guidelines on how such protocols should be configured
  521.           for use as a "mailer protocol".  Such guidelines are general,
  522.           however, and can be applied to any protocol which you may care to
  523.           use.
  524.  
  525.           2.8  Networks and multitasking
  526.  
  527.           EchoSprint has been tested exhaustively under DESQview, within
  528.           OS/2 virtual DOS machines and under Microsoft Windows with
  529.           pleasing results.
  530.  
  531.           Inclusion of EchoSprint into a multitasking system is very
  532.           simple, since EchoSprint occupies much less RAM than front-ends
  533.           themselves and behaves in similar ways.  EchoSprint also
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.                                      - 10 -
  542.  
  543.           timeslices and uses DESQview video buffers if DESQview is
  544.           detected.
  545.  
  546.           Installation of EchoSprint into networks is quite simple - define
  547.           any paths for both FrontDoor and EchoSprint as one of any
  548.           remapped public directories, and place EchoSprint's files onto
  549.           the file server.  EchoSprint has been tested under Novell NetWare
  550.           3.1.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                      - 11 -
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.                                   Chapter 3
  604.  
  605.                                 CONFIGURATION
  606.  
  607.  
  608.           3.1  The configuration editor
  609.  
  610.           Now that EchoSprint is correctly installed on your system, it is
  611.           time to configure the package.  Make the EchoSprint directory the
  612.           active directory and enter ES CONFIGURE.
  613.  
  614.           The full-screen configuration editor will be loaded and default
  615.           values will be created.  The main menu of configuration items
  616.           will appear.
  617.  
  618.           3.1.1  Navigating the configuration editor
  619.  
  620.           Configuration items may be selected by moving the highlight bar
  621.           over the item and pressing <Enter>.  Various sub-windows may be
  622.           opened as a result of this, the items on the sub-window will
  623.           require selection in a similar manner.
  624.  
  625.           In some cases, these sub-windows will contain a number of
  626.           "buttons", which are shown as a pair of parentheses, with an
  627.           optional dot between them.  When this dot is shown, the
  628.           corresponding option is selected.  Buttons are selected with the
  629.           space bar.
  630.  
  631.           At any time whilst using the configuration editor, the following
  632.           keys are available:
  633.  
  634.           <F1>  Keyboard help.  This key will show a list of possible
  635.                 hotkeys, available at any position in the configuration
  636.                 editor.
  637.  
  638.           <F2>  Shell to DOS.  Type "EXIT" to return to the configuration
  639.                 editor.
  640.  
  641.           <F3>  Jump to FrontDoor Setup program.  The environment variable
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.                                      - 12 -
  650.  
  651.                 "FD" will be searched for a path to the FrontDoor setup
  652.                 program, which will be run in a shell.  This is useful for
  653.                 making changes on-the-fly and making comparisons.  If the
  654.                 FD environment variable does not exist or FDSETUP.EXE does
  655.                 not exist in the directory specified by the variable
  656.                 contents, then an error message will be displayed.
  657.  
  658.           The configuration may be saved, when completed, by returning from
  659.           the current window to the main menu by pressing <Esc> as many
  660.           times as required to close the open windows.  Pressing <Esc> at
  661.           the main menu will prompt you to save changes.  Press <Y> to save
  662.           changes and exit, <N> to exit and to lose changes, or <Esc> to
  663.           return to the main menu of the configuration editor.
  664.  
  665.           If no apparent changes have been made to the configuration (ie.
  666.           you were just browsing your configuration), pressing <Esc> will
  667.           exit the configuration editor immediately, and you will not be
  668.           prompted to save changes.
  669.  
  670.           3.1.2  File sharing
  671.  
  672.           This option can be set to either "Yes" or "No".  If you are
  673.           running EchoSprint on a local area network or under a
  674.           multitasker, be sure to enable file sharing.  Not doing this may
  675.           result in corruption of various files during use.
  676.  
  677.           If EchoSprint is only being used in a single-tasking,
  678.           stand-alone environment, file sharing may be disabled (ie. set to
  679.           "No").
  680.  
  681.           3.1.3  Errorlevels
  682.  
  683.           This set of errorlevels are returned to the batch file after
  684.           EchoSprint exits with a condition; be it success or failure.  Be
  685.           sure your batch file accounts for all possibilities.
  686.  
  687.           Several internal errorlevels are issued for internal or fatal
  688.           errors.  These are identical to the internal errorlevels issued
  689.           by FrontDoor.  Refer to the relevant section of the FrontDoor
  690.           User's Guide for information on these errorlevels.
  691.  
  692.           3.1.3.1  Session success
  693.  
  694.           This errorlevel is returned when EchoSprint exits after a
  695.           successful mail session (but no mail was received).
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.                                      - 13 -
  704.  
  705.           3.1.3.2  Session denial
  706.  
  707.           This errorlevel is returned when EchoSprint exits after a call if
  708.           the remote system refused connection due to event behaviour or a
  709.           session level denial.
  710.  
  711.           3.1.3.3  Session failure
  712.  
  713.           This errorlevel is returned when EchoSprint exits after a mail
  714.           session if the session was terminated by either Sysop or line
  715.           noise leading to a loss of carrier.  This errorlevel will also
  716.           be returned if EchoSprint is invoked in answer mode, but no
  717.           carrier was present.  This usually occurs if the calling system
  718.           disconnected between the exchange of control between FrontDoor
  719.           and EchoSprint on the answering system.
  720.  
  721.           3.1.3.4  Handshake failure
  722.  
  723.           This errorlevel is returned when EchoSprint exits after a call if
  724.           a handshake could not be completed, due either to an incorrect
  725.           session level password or line noise.  The handshake will be
  726.           retried for up to 30 seconds.
  727.  
  728.           3.1.3.5  No modem response
  729.  
  730.           This errorlevel is returned when EchoSprint exits after
  731.           attempting to initialise the modem when starting an outbound
  732.           session.
  733.  
  734.           3.1.4  File requests
  735.  
  736.           This setting, either "BinkleyTerm style" or "FrontDoor style"
  737.           defines how file request failures will be announced.
  738.  
  739.           If "BinkleyTerm style" is chosen, then the file FREQFAIL.TPL will
  740.           be used (if not, you may delete it).  When this option is chosen,
  741.           failures will be returned as a *.RSP file, containing the
  742.           contents of the template, where any macros will be replaced with
  743.           the session details.
  744.  
  745.           If "FrontDoor style" is chosen, then a failure message similar to
  746.           FrontDoor's will be sent, with a message file appended, if one is
  747.           defined in FrontDoor's Setup program.
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.                                      - 14 -
  758.  
  759.           3.1.5  Nodelists
  760.  
  761.           EchoSprint uses FidoNet compatible nodelists to contact other
  762.           systems.  These nodelists must be fully FTS-0005 compliant (ie.
  763.           identical in format to the common FidoNet nodelist).
  764.  
  765.           This configuration item consists of ten separate fields.  Each
  766.           field may contain the filename of a nodelist (which must be found
  767.           in the FrontDoor nodelist directory) to be compiled into the
  768.           common indexes for EchoSprint to reference.
  769.  
  770.           Commented lines (ie. any line beginning with the semicolon
  771.           character, ";") will be ignored by the compiler.
  772.  
  773.           3.2  FrontDoor configuration
  774.  
  775.           As mentioned in the features of EchoSprint, the package is highly
  776.           integrated with FrontDoor - and in particular, its configuration.
  777.           It would be quite easy to implement all the FrontDoor
  778.           configuration items into EchoSprint and its configuration editor,
  779.           but it just makes setting up the package more difficult in the
  780.           first instance.
  781.  
  782.           For this reason, much of the configuration data EchoSprint needs
  783.           is extracted from FrontDoor's configuration files.  Namely:
  784.           SETUP.FD, EVENT.FD, ROUTE.FD, and optionally REQUEST.FD,
  785.           PASSWORD.FD and MODEM.FD.
  786.  
  787.           A few simple "rules" must be followed when configuring EchoSprint
  788.           within FrontDoor's Setup program.  All relevant information for
  789.           EchoSprint's operation is used from FrontDoor's matching
  790.           components.  For example, if you have four network addresses and
  791.           present all AKAs to remote systems with FrontDoor, EchoSprint
  792.           will do the same.  If your system runs flawlessly using
  793.           FrontDoor's own transfer engine, then EchoSprint will behave in
  794.           an identical way.
  795.  
  796.           Invoke FDSETUP.EXE (for FrontDoor) by pressing <F4> from
  797.           EchoSprint's configuration editor (if the FrontDoor configuration
  798.           editor can be found).  Alternatively, enter the FrontDoor system
  799.           directory and type FDSETUP to load this program.
  800.  
  801.           3.2.1  Configuration requirements
  802.  
  803.           EchoSprint assumes the following, in order for it to correctly
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.                                      - 15 -
  812.  
  813.           operate:
  814.  
  815.           o  That the event tag to use in an outbound call is correctly
  816.              defined and has an accompanying schedule block in ROUTE.FD.
  817.  
  818.           o  That EchoSprint is in fact loaded by the batch file when the
  819.              "EchoSprint" external mail string is received.  There may be
  820.              exceptions to this: see section 7.1.
  821.  
  822.           3.2.2  External mail strings
  823.  
  824.           For your system to answer inbound G2U mail calls, you must create
  825.           an external mail string for FrontDoor to detect G2U mailers.
  826.  
  827.           >  Go to Mailer > External mail
  828.  
  829.           In the first available blank line from the top, enter a mail
  830.           string of "EchoSprint" (be sure to correctly capitalise this) and
  831.           set an unused errorlevel for your batch file.
  832.  
  833.           3.2.3  Events
  834.  
  835.           This section of the EchoSprint installation could easily be the
  836.           most difficult for many users.  Proceed through the following
  837.           sections slowly to ensure the configuration is done correctly.
  838.  
  839.           3.2.3.1  Event configuration and entry
  840.  
  841.           >  Go to Manager > Events
  842.  
  843.           For each event where you will be polling another G2U capable
  844.           system, set the event to inactive.
  845.  
  846.           >  Behaviour > Inactive > Yes
  847.  
  848.           As an example, if you poll three systems nightly, but one of them
  849.           still uses another mailer's internal protocols, you should make a
  850.           duplicate copy of your poll event and make the duplicate one
  851.           inactive.  Do this by keeping the original event (say, event A)
  852.           active, for your poll using internal mailer protocols.  Check the
  853.           event behaviour for event A and create an event (called B) for
  854.           your G2U capable systems.
  855.  
  856.           Make the duplicate event inactive.  The time when the event is
  857.           run is unimportant, but the length of the event will be treated
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                                      - 16 -
  866.  
  867.           in the same manner as event A.  Be sure that event B is inactive
  868.           and create an external "X" event, using an unused errorlevel for
  869.           your batch file.  During this external event, EchoSprint will be
  870.           run, and will be instructed to run event B (the inactive event).
  871.           The event length of the inactive event will be used to determine
  872.           how long the external mail event will be run for.
  873.  
  874.           3.2.3.2  Schedule tags/mail routing
  875.  
  876.           Once you have an inactive EchoSprint mail event, you should
  877.           update your mail routing file (ROUTE.FD) so that it will never
  878.           send any mail via the actual front-end mailer.
  879.  
  880.           Continuing on from the above example of two events ("A" using
  881.           protocols internal and "B" being G2U capable), adjust SCHEDULE A
  882.           in your ROUTE.FD so that no mail is sent using the front-end
  883.           mailer to your EchoSprint capable systems and create a new
  884.           SCHEDULE B to send mail to the EchoSprint capable systems.  This
  885.           will be handled by EchoSprint.
  886.  
  887.           Remember that conference mail must be scanned as usual before
  888.           sending it to the EchoSprint capable node and that crash mail and
  889.           immediate mail outside EchoSprint events will be sent by your
  890.           front-end mailer using its own protocols.
  891.  
  892.           Within each EchoSprint event schedule, a number of new commands
  893.           are implemented.  Some are in fact FrontDoor routing verbs, but
  894.           behave in slightly different ways.
  895.  
  896.           POLL       This verb instructs EchoSprint to poll a given system.
  897.                      The POLL verb must be followed by a single
  898.                      3-dimensional or 4-dimensional address.
  899.  
  900.                      For example:
  901.  
  902.                      POLL 3:620/201
  903.  
  904.                      or
  905.  
  906.                      POLL 58:2600/104.1
  907.  
  908.                      A missing point field assumes "point 0" of the given
  909.                      node.  The zone field must be complete.  Any errors in
  910.                      syntax will cause EchoSprint to exit immediately upon
  911.                      initialisation and place a warning notice in the
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.                                      - 17 -
  920.  
  921.                      FrontDoor log file.
  922.  
  923.           ROUTE-TO   This verb instructs EchoSprint to deliver ARCmail and
  924.                      files attaches for nodes listed to the system being
  925.                      polled.  This verb can be placed before or after the
  926.                      POLL verb.  EchoSprint will, by default, collect mail
  927.                      for all of your AKAs (unless the "Pickup waiting mail"
  928.                      event behaviour is set to "No" in the schedule to be
  929.                      used by EchoSprint.
  930.  
  931.                      The ROUTE-TO verb is to be followed by a series of
  932.                      addresses (either 3- or 4-dimensional).  If line
  933.                      length exceeds 255 characters in ROUTE.FD, additional
  934.                      ROUTE-TO verb lines may be added.  Any errors in
  935.                      syntax will cause EchoSprint to exit immediately upon
  936.                      initialisation and place a warning notice in the
  937.                      FrontDoor log file.
  938.  
  939.           PROTOCOL   This verb specifies a identifying keyword for the
  940.                      protocol you are using in this event.  The remote
  941.                      system must have the same keyword listed somewhere in
  942.                      their ROUTE.FD file.  Failure to meet this condition
  943.                      will result in a handshake failure.  Try to adopt
  944.                      common keywords across your network(s).  For example,
  945.                      when using BiModem, use the standardised protocol
  946.                      keyword of "BIMODEM".
  947.  
  948.                      This keyword is not case sensitive, however.
  949.  
  950.           EXECUP     This verb specifies the command line to be executed
  951.                      when requiring this protocol to be executed in upload
  952.                      mode.
  953.  
  954.           EXECDOWN   This verb specifies the command line to be executed
  955.                      when requiring this protocol to be executed in
  956.                      download mode.
  957.  
  958.           EXECBOTH   If this verb is used, it is assumed that the protocol
  959.                      supports bidirectional file transfers.  In that case,
  960.                      this verb specifies the command line to be executed
  961.                      when requiring this protocol to be executed in either
  962.                      upload mode, download mode, or both.
  963.  
  964.           LOG        This verb specifies the path and filename of the DSZ
  965.                      compatible log file which must be created by the
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.                                      - 18 -
  974.  
  975.                      external protocol.  Failure to specify this verb, or
  976.                      if the protocol does not create a 100% compatible DSZ
  977.                      transfer log file, may result in lost files if calls
  978.                      are disconnected prior to all files being transferred.
  979.  
  980.                      This log file is removed by EchoSprint every time it
  981.                      is run.  There is no need to retain the information
  982.                      from this log, however, since EchoSprint will place
  983.                      all relevant information in the FrontDoor log file.
  984.  
  985.           3.2.3.3  Event behaviour
  986.  
  987.           Besides the inactive flag in the event behaviour window of
  988.           FrontDoor's Setup program, other flags which EchoSprint
  989.           recognises are:
  990.  
  991.           o  Exit when mail is received
  992.  
  993.           o  Allow file requests
  994.  
  995.           o  Attempt to pickup waiting mail
  996.  
  997.           o  Allow nodes to pick up waiting mail
  998.  
  999.           o  Pickup file requests
  1000.  
  1001.           o  Hold (don't send) file requests
  1002.  
  1003.           o  Prioritise outbound calls
  1004.  
  1005.           It would also be a good idea, but not necessary, to set the
  1006.           "Forced" field of the event behaviour of your external event
  1007.           which calls EchoSprint to "No".
  1008.  
  1009.           This will treat the event identically to standard FrontDoor mail
  1010.           events - it will ignore them if missed.
  1011.  
  1012.           It might also be useful to set Forced to Yes, if the BBS is down
  1013.           for a few hours due to a power failure, over your mail event.  In
  1014.           this case, as soon as the machine comes back online, it will poll
  1015.           for you.
  1016.  
  1017.           3.2.3.4  Global answering event
  1018.  
  1019.           On inbound calls, EchoSprint refers to the event behaviour of the
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.                                      - 19 -
  1028.  
  1029.           currently active FrontDoor event.
  1030.  
  1031.           3.2.4  File requests
  1032.  
  1033.           EchoSprint's file request engine handles file requests in *.MSG
  1034.           (Opus 1.03) format.  Update requests are handled in identical
  1035.           ways to FrontDoor and furthermore, passwords are compared with
  1036.           REQUEST.SYS for password-protected files.  FrontDoor's session
  1037.           limits are also adhered to.
  1038.  
  1039.           A new feature has been added to EchoSprint's file request engine.
  1040.           If a file is requested, such as RAFTOOLS.ZIP, sending a file
  1041.           request of RAFTOOLS.ZIP&S, will return only one file from all the
  1042.           directories - the largest file.  If duplicates exist, still only
  1043.           one will be sent.  Requesting RAFTOOLS.ZIP&D will send one file,
  1044.           also - the one with the most recent date stamp.
  1045.  
  1046.           File requests will only be honoured when time and event behaviour
  1047.           allows it.
  1048.  
  1049.           File requests should be composed in the same way as previously
  1050.           (ie. adding " !password" to password-protected file requests).
  1051.  
  1052.           3.2.4.1  Alias names
  1053.  
  1054.           Alias file request names will be scanned using the FrontDoor
  1055.           "alias" list (for both secure and unsecured sessions).  Be sure
  1056.           FrontDoor has been given an alias list filename and that the file
  1057.           exists, using the format:
  1058.  
  1059.           ALIAS C:\FILENAME.EX1 C:\FILENAME.EXn
  1060.  
  1061.           where ALIAS is the alias name, C:\FILENAME.EX1 the path of the
  1062.           first file to send and C:\FILENAME.EXn is the last file to send.
  1063.  
  1064.           3.2.4.2  Update requests
  1065.  
  1066.           Update requests are also handled by EchoSprint in an identical
  1067.           fashion to FrontDoor - by checking the date of the existing file
  1068.           on your system and sending an update if required.
  1069.  
  1070.           3.2.4.3  Requestable directories
  1071.  
  1072.           Similarly with alias names, EchoSprint will refer to the
  1073.           requestable directories list provided to FrontDoor.  If a file
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.                                      - 20 -
  1082.  
  1083.           request is placed, all matching files in the listed directories
  1084.           will be sent.  The format for the requestable directories list
  1085.           is:
  1086.  
  1087.           \DIR1\
  1088.           \DIR2\
  1089.  
  1090.           and so on.
  1091.  
  1092.           Where \DIR1\ and \DIR2\ are directories where file requests may
  1093.           be made from.
  1094.  
  1095.           Like FrontDoor, trailing backslashes in the requestable
  1096.           directories list are optional.
  1097.  
  1098.           3.2.4.4  Service/server requests
  1099.  
  1100.           Due to the nature of these requests, an external protocol is
  1101.           rarely useful in using service and server requests.
  1102.  
  1103.           It is suggested that these messages be written and sent using the
  1104.           immediate mail sending function of your front-end mailer.
  1105.  
  1106.           3.2.4.5  File request failures
  1107.  
  1108.           If a file request cannot be satisfied for some reason, such as a
  1109.           missing file or an incorrect password, then a failure message
  1110.           will be included amongst the transferred files.
  1111.  
  1112.           If the configuration has been set to use the FrontDoor style
  1113.           message, then see section 3.2.4.5.2 for further information.  If
  1114.           you will be using the BinkleyTerm style template file, see
  1115.           section 3.2.4.5.1.
  1116.  
  1117.           All files requested from your system will be accounted for in
  1118.           your FrontDoor log file.
  1119.  
  1120.           3.2.4.5.1  BinkleyTerm style (template)
  1121.  
  1122.           The template file, FREQFAIL.TPL, is customisable by yourself to
  1123.           add the details you wish to use in your failure messages that
  1124.           FrontDoor does not offer (BinkleyTerm does).
  1125.  
  1126.           A sample FREQFAIL.TPL is included in the distribution archive.
  1127.           The layout is broken down into several sections or blocks; each
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.                                      - 21 -
  1136.  
  1137.           section relating to a different failure condition (in order from
  1138.           beginning to the end of the template):
  1139.  
  1140.           o  Missing file
  1141.  
  1142.           o  Password failure
  1143.  
  1144.           o  Out of time
  1145.  
  1146.           o  Out of kilobytes (allowed per poll)
  1147.  
  1148.           o  Too many files
  1149.  
  1150.           o  No update required
  1151.  
  1152.           o  Baud rate too slow to FREQ
  1153.  
  1154.           o  Not allowed to request
  1155.  
  1156.           o  No FREQs currently allowed
  1157.  
  1158.           Each block is separated by three dashes, starting from column 1.
  1159.  
  1160.           Here is a more comprehensive look at the template file:
  1161.  
  1162.           ; Missing file
  1163.           ---
  1164.           Sorry, %N, I don't have that file online, sorry.
  1165.  
  1166.           Send me NetMail to %A if you think it is just offline.
  1167.  
  1168.           Thank you.
  1169.           %S
  1170.  
  1171.           ; Password failure
  1172.           ---
  1173.           %F has failed - it requires a correct password before it may be
  1174.           file requested.
  1175.  
  1176.           ; Next block, etc.
  1177.           ---
  1178.   
  1179.           and so on.  Spacing with blank lines is accepted and comments may
  1180.           be placed in the template using semi-colons (";") starting in
  1181.           column 1.  If these are placed on any other column than 1,
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.                                      - 22 -
  1190.  
  1191.           EchoSprint will assume this is text to be placed in the message.
  1192.  
  1193.           The order of each error condition is vital - be sure your message
  1194.           for systems requesting files without a correct password is second
  1195.           in the template, for example.
  1196.  
  1197.           Once your template has been constructed, you may test its
  1198.           validity using the template checking facility.  This is a single
  1199.           pass scanner for testing the correctness of the template's
  1200.           layout.  You will be informed of errors, but once the layout is
  1201.           correct, you will be given samples of each to show you how the
  1202.           messages will look.  To run this, type ES TEMPLATE at a command
  1203.           prompt.  The resulting sample file will be called SAMPLE.RSP, and
  1204.           can be found in the EchoSprint directory.
  1205.  
  1206.           As a tip, be sure to place variables that can be unexpectedly
  1207.           long (such as the remote Sysop's name) as close to column 1 as
  1208.           possible.  Trying to centre some variable, such as the remote
  1209.           Sysop's name, will rarely result in pleasing output and may even
  1210.           be wrapped to the next line, looking very ugly indeed.
  1211.  
  1212.           Here is a list of available macros.  Insert them into the text
  1213.           using %_, where _ is the macro label (ie. %S for your name).
  1214.  
  1215.           Macro    Result
  1216.           -----------------------------------------------------------------
  1217.           A        Your network address (or used alias, such as 58:2600/0).
  1218.           B        Established baud rate.
  1219.           C        Caller's network address.
  1220.           D        Today's date.
  1221.           E        Error type (Missing file, etc.)
  1222.           F        File(s) which failed.
  1223.           G        Calling Sysop's first name.
  1224.           H        Calling Sysop's last name.
  1225.           I        Minimum baud rate for FREQs.
  1226.           J        Maximum number of files allowed per poll.
  1227.           K        Maximum file(s) size for FREQs.
  1228.           L        Caller's location.
  1229.           M        Your location.
  1230.           N        Calling Sysop's name.
  1231.           O        Caller's system name.
  1232.           P        Attempted file password.
  1233.           S        Your name.
  1234.           T        Time (either AM/PM or military, depending on country).
  1235.           U        Maximum time for FREQs.
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.                                      - 23 -
  1244.  
  1245.           V        Current version information for EchoSprint.
  1246.           Y        The soonest time FREQs will be honoured.
  1247.           Z        EchoSprint copyright information.
  1248.  
  1249.           If variables are irrelevant, their contents are blank (for
  1250.           example, if a file was requested without a password, but it
  1251.           failed due to being offline, then %P will continue to yield a
  1252.  
  1253.           blank).
  1254.  
  1255.           3.2.4.5.2  FrontDoor style (message)
  1256.  
  1257.           The FrontDoor style failure message will send a hard coded
  1258.           failure notice, detailing the files which could not be sent.  In
  1259.           addition, if your own failure message is added to the FrontDoor
  1260.           message in FrontDoor's configuration editor, it will be appended
  1261.           to the message.
  1262.  
  1263.           >  Mailer > File requests > Message defines the name of the
  1264.           included file.
  1265.  
  1266.           3.3  Nodelists
  1267.  
  1268.           EchoSprint includes its own nodelist compiler.  It expects to
  1269.           find any defined nodelists (via the configuration editor) in the
  1270.           FrontDoor nodelist directory.
  1271.  
  1272.           >  Global > Filenames > Nodelist defines the path to the nodelist
  1273.           files.
  1274.  
  1275.           EchoSprint will create its index files in this directory.
  1276.  
  1277.           3.3.1  Compiling nodelists
  1278.  
  1279.           Once the necessary nodelists are installed in the FrontDoor
  1280.           nodelist directory, all that is further required to completely
  1281.           configure EchoSprint's nodelist support is to run the compiler.
  1282.  
  1283.           To do this, enter the EchoSprint directory and enter ES COMPILE.
  1284.           The compiler will scan the raw nodelist(s) and generate index
  1285.           files as required.  The number of nodes compiled and any
  1286.           uncompiled nodelists will be reported in the FrontDoor log file.
  1287.  
  1288.           More detail on the command line parameters for EchoSprint is
  1289.           provided in section 4.2.
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.                                      - 24 -
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.                                   Chapter 4
  1306.  
  1307.                                   ECHOSPRINT
  1308.  
  1309.  
  1310.           This chapter, which describes the technicalities to operating
  1311.           EchoSprint, will be most beneficial to users who are very
  1312.           familiar with FidoNet compatible mail software.  They should be
  1313.           able to quickly scan this chapter and extract most of the
  1314.           information that they will need.
  1315.  
  1316.           4.1  The executable
  1317.  
  1318.           The executable program is incredibly small for its task, occupies
  1319.           a very small amount of RAM (for running in memory restricted
  1320.           systems and under multitaskers) and due to its optimisation, runs
  1321.           extremely quickly.
  1322.  
  1323.           As an illustration of this speed, this week's FidoNet nodelist
  1324.           (approximately 1,450KB in size) compiles using the EchoSprint
  1325.           nodelist compiler in nine seconds.
  1326.  
  1327.           To further increase the compactness of this package, the
  1328.           executable file (ES.EXE) has been compressed using PKLite.
  1329.  
  1330.           To avoid the possibility of a file virus attaching itself to
  1331.           EchoSprint, it is possible to set the read-only and/or hidden
  1332.           file attributes to ES.EXE.
  1333.  
  1334.           4.2  Command line parameters
  1335.  
  1336.           EchoSprint requires command line parameters for any of its
  1337.           operations.  These parameters may be in uppercase, lowercase, or
  1338.           any combination of these.
  1339.  
  1340.           o  Valid syntax: Poll, pOll, POLL, poll
  1341.  
  1342.           Any of the parameters may optionally be proceeded by a forward
  1343.           slash character ("/"), if this is preferred.
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.                                      - 25 -
  1352.  
  1353.           o  Valid syntax: POLL, /POLL
  1354.  
  1355.           Any secondary parameters which have arguments (Event and Password
  1356.           are the only two), must have a colon character (":") separating
  1357.           the parameter and the argument.
  1358.  
  1359.           o  Valid syntax: EVENT:A, /PASSWORD:SECRET
  1360.  
  1361.           4.2.1  Poll
  1362.  
  1363.           This option will invoke EchoSprint in mailer mode to poll a
  1364.           system.
  1365.  
  1366.           The systems to poll and routing is defined in ROUTE.FD for the
  1367.           event to be run, and the behaviour is defined by the inactive
  1368.           event FrontDoor's event manager.
  1369.  
  1370.           This parameter carries with it one optional parameter (Event) and
  1371.           one compulsory parameter (Password).
  1372.  
  1373.           See Section 4.2.6 and Section 4.2.7, respectively, for further
  1374.           details on these secondary parameters.
  1375.  
  1376.           o  Example: ES /POLL /EVENT:M /PASSWORD:AARDVARK
  1377.  
  1378.           4.2.2  Answer
  1379.  
  1380.           This option will invoke EchoSprint in mailer mode, once again, to
  1381.           answer an inbound call.  EchoSprint expects a carrier to be
  1382.           present upon loading, which will have a G2U system online, ready
  1383.           to handshake with.
  1384.  
  1385.           The event behaviour will be determined by the event running at
  1386.           the time the front-end answered the call.
  1387.  
  1388.           There are no secondary parameters for Answer.
  1389.  
  1390.           o  Example: ES /ANSWER
  1391.  
  1392.           4.2.3  Configure
  1393.  
  1394.           This option will invoke EchoSprint's configuration editor.
  1395.  
  1396.           There are no secondary parameters for Configure.
  1397.  
  1398.           o  Example: ES /CONFIGURE
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.                                      - 26 -
  1406.  
  1407.           4.2.4  Compile
  1408.  
  1409.           This option will invoke EchoSprint's nodelist compiler.  It runs
  1410.           completely unattended, so it may be added to maintenance batch
  1411.           files for compiling new nodelists and so on.
  1412.  
  1413.           The total number of compiled nodes will be added to the log file.
  1414.  
  1415.           There are no secondary parameters for Compile.
  1416.  
  1417.           o  Example: ES /COMPILE
  1418.  
  1419.           4.2.5  Template
  1420.  
  1421.           This option will invoke EchoSprint's template file verifier for
  1422.           FREQFAIL.TPL (used with BinkleyTerm style file request failure
  1423.           messages).  The output of this function may be too fast to read,
  1424.           but its actions are logged in the FrontDoor log file.
  1425.  
  1426.           There are no secondary parameters for Template.
  1427.  
  1428.           o  Example: ES /TEMPLATE
  1429.  
  1430.           4.2.6  Password
  1431.  
  1432.           Generally, you will want to configure your front-end to allow
  1433.           exits to EchoSprint upon receipt of the standard "EchoSprint"
  1434.           external mail string.
  1435.  
  1436.           This will allow a majority of systems who have not previously
  1437.           arranged a secured mail feed to connect to your system using a
  1438.           high performance protocol for file requests, crash mail, and so
  1439.           on.
  1440.  
  1441.           If you wish to present a different external mail string to the
  1442.           remote system when polling, use the Password parameter.
  1443.  
  1444.           This is useful for the high security mail or for the remote
  1445.           system to be able to determine which system is calling before
  1446.           loading EchoSprint in answer mode.
  1447.  
  1448.           With this, actions can be taken in the intermediate process to
  1449.           customise operations (for example, routing files or configuration
  1450.           files can be renamed to exchange active files).
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.                                      - 27 -
  1460.  
  1461.           If the Password parameter is not used, the default mail string
  1462.           of "EchoSprint" will be sent to the remote system.
  1463.  
  1464.           This parameter can only be used with the Poll primary parameter.
  1465.  
  1466.           o  Example: ES /POLL /EVENT:A /PASSWORD:AARDVARK
  1467.  
  1468.           4.2.7  Event
  1469.  
  1470.           This compulsory parameter for the Poll option specifies the
  1471.           inactive event information to extract from FrontDoor's
  1472.           configuration files.  This includes event behaviour and mail
  1473.           routing information.
  1474.  
  1475.           Valid event tags are a single alphabetic character, except "X"
  1476.           (which is reserved for external events).  The global event tag,
  1477.           @, may also be used.
  1478.  
  1479.           The length of the @ event is always one minute.  EchoSprint will
  1480.           carry out every poll listed in ROUTE.FD within the @ schedule
  1481.           block before exiting.
  1482.  
  1483.           Note that the @ event cannot be made inactive, so EchoSprint's
  1484.           unique routing verbs may generate curious responses from
  1485.           FrontDoor.  If your front-end mailer is not FrontDoor, then of
  1486.           course, this trivial problem will not occur.
  1487.  
  1488.           It is certainly possible to use the @ event, but it is not
  1489.           suggested (nor should it be necessary).
  1490.  
  1491.           This parameter can only be used with the Poll primary parameter.
  1492.  
  1493.           o  Example: ES /POLL /EVENT:A
  1494.  
  1495.           4.2.8  Manual
  1496.  
  1497.           This option will invoke EchoSprint's in-built manual reader.  If
  1498.           your User's Guide is kept online in the EchoSprint directory, it
  1499.           can be browsed at any time using this option.
  1500.  
  1501.           The following keys are available within the manual reader:
  1502.  
  1503.           <Up>    Scrolls up through the User's Guide by one line.
  1504.  
  1505.           <Down>  Scrolls down through the User's Guide by one line.
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.                                      - 28 -
  1514.  
  1515.           <Left>   Jumps to the previous page of the User's Guide.
  1516.  
  1517.           <Right>  Jumps to the next page of the User's Guide.
  1518.  
  1519.           <PgUp>   Jumps to the top of the current page.
  1520.  
  1521.           <PgDn>   Jumps to the bottom of the current page.
  1522.  
  1523.           <Home>   Jumps to the first page of the User's Guide.
  1524.  
  1525.           <End>    Jumps to the final page of the User's Guide.
  1526.  
  1527.           <Esc>    Allows exiting from the manual reader.  You will be
  1528.                    prompted to verify that you wish to exit.  Pressing <Y>
  1529.                    will exit back to the command prompt.  Pressing <N> or
  1530.                    <Esc> again will return you to the manual reader.
  1531.  
  1532.           <F1>     Jumps to the index of the User's Guide.
  1533.  
  1534.           <F2>     Prompts for a page number to go to.  This is extremely
  1535.                    useful if you have previously jumped to the index and
  1536.                    found an item of interest on a given page number.  You
  1537.                    can press <F2>, enter the page number and very quickly,
  1538.                    you are on the page containing the material you wish to
  1539.                    read.
  1540.  
  1541.           There are no secondary parameters for Manual.
  1542.  
  1543.           o  Example: ES /MANUAL
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.                                      - 29 -
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.                                   Chapter 5
  1576.  
  1577.                              OPERATIONAL OVERVIEW
  1578.  
  1579.  
  1580.           This chapter will briefly describe the workings of EchoSprint
  1581.           through day-to-day operations.  Knowing what actually goes on is
  1582.           useful for working out problems much more quickly.
  1583.  
  1584.           5.1  Handshaking
  1585.  
  1586.           When EchoSprint makes an outbound call to another system, it will
  1587.           dial until the inactive event ends or until it connects.  As soon
  1588.           as the machines connect, the password string (usually
  1589.           "EchoSprint") is sent down the line to the remote system).
  1590.  
  1591.           EchoSprint will wait up to 30 seconds for the G2U handshake
  1592.           enquiry to be sent from the remote system before disconnecting.
  1593.  
  1594.           5.2  Sessions
  1595.  
  1596.           When the handshake begins, the following takes place on each end
  1597.           of the transfer:
  1598.  
  1599.           5.2.1  Polls
  1600.  
  1601.           The machine making the outbound call then responds to the enquiry
  1602.           with an acknowledgement packet consisting of its system details,
  1603.           a list of waiting outbound files, and a list of file requests, if
  1604.           any.
  1605.  
  1606.           5.2.2  Inbound sessions
  1607.  
  1608.           If the remote system does not deny access, it will return its
  1609.           system information to the calling system, including a list of
  1610.           waiting outbound files for the caller to collect and a list of
  1611.           file requests if any.  Also within this packet is a total size of
  1612.           files which the calling system had just requested.
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.                                      - 30 -
  1622.  
  1623.           This packet will be transmitted, and finally, in the third pass
  1624.           of the handshake, the calling system will return the total size
  1625.           of files which the answering system requested.
  1626.  
  1627.           The protocol to be used will be defined by the calling system,
  1628.           and if the same protocol keyword does not exist in the answering
  1629.           system's ROUTE.FD file as a PROTOCOL entry, the call will be
  1630.           disconnected with a session failure condition.
  1631.  
  1632.           5.3  File transfers
  1633.  
  1634.           The list of files to be received will be displayed on the mailer
  1635.           screen, followed by an accurate estimate of the session length
  1636.           (in minutes and seconds).
  1637.  
  1638.           If the protocol to be used is bidirectional, the EXECBOTH (from
  1639.           ROUTE.FD) line will be executed simultaneously on both machines.
  1640.  
  1641.           If it is a unidirectional transferring method, the calling system
  1642.           will invoke EXECUP followed by EXECDOWN, and the answering system
  1643.           will invoke EXECDOWN followed by EXECUP.
  1644.  
  1645.           When executing any EXEC command lines from ROUTE.FD, EchoSprint
  1646.           will replace all occurrences of the carat character ("^") with
  1647.           the path to the temporary outbound file list (such as
  1648.           C:\ES\OUTBOUND.ES).  This file will be automatically maintained
  1649.           by EchoSprint, so you should not be concerned about systems
  1650.           receiving files from a previous session with another system.
  1651.  
  1652.           The mailer screen will be cleared prior to loading these
  1653.           protocols and will log their exit conditions upon returning to
  1654.           the mailer.
  1655.  
  1656.           5.4  File requests
  1657.  
  1658.           File requests will be processed during the handshake negotiation
  1659.           and any files which cannot be sent will generate a failure
  1660.           message (whose "flavour" depends on your selection in the
  1661.           EchoSprint configuration editor).  These packets (.PKT) or
  1662.           response files (.RSP) will be added to the outbound file list.
  1663.  
  1664.           5.5  Log file
  1665.  
  1666.           EchoSprint records all its actions in FrontDoor's log file (using
  1667.           the Homrighausen log format).  How much of the on-screen logging
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.                                      - 31 -
  1676.  
  1677.           which is actually stored in the log is defined in FrontDoor's
  1678.           configuration editor.
  1679.  
  1680.           EchoSprint carefully uses the correct "action ID" characters for
  1681.           the log file, so that FrontDoor compatible log analysers may b
  1682.           used to analyse EchoSprint mail sessions (ie. "=" defines a modem
  1683.           response string).
  1684.  
  1685.           5.6  Miscellaneous
  1686.  
  1687.           For EchoSprint to determine which files have been completely
  1688.           transferred during a session, it refers to the log file defined
  1689.           in ROUTE.FD next to the "LOG" verb for the protocol being used.
  1690.  
  1691.           This log file must be fully DSZ compatible, otherwise files may
  1692.           be removed which were not sent due to a failed session (such as
  1693.           line noise).  The log file will be processed, logging transfers
  1694.           to the FrontDoor log file (if necessary), and deleting or
  1695.           truncating file attaches as necessary.  Whether files are
  1696.           truncated, deleted, or neither is extracted from the file attach
  1697.           message flags.  If "KFS" is set, the file will be deleted.  If
  1698.           "TFS" is set, the file will be truncated to zero length.
  1699.  
  1700.           Once the DSZ log file has been fully processed, EchoSprint will
  1701.           remove it.  As mentioned above, any information in it will be
  1702.           transferred to the FrontDoor log file.
  1703.  
  1704.           It should also be carefully noted that EchoSprint will only send
  1705.           NetMail which is compressed into an ARCmail bundle.  If a NetMail
  1706.           file attach message is found which is addressed to the remote
  1707.           system and has text in its message body, the text will not be
  1708.           transferred and the message will be deleted once its attached
  1709.           files have been successfully transferred.
  1710.  
  1711.           Be careful to compress any NetMail into an ARCmail bundle if you
  1712.           wish to transfer it via an EchoSprint session.
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.                                      - 32 -
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.                                   Chapter 6
  1738.  
  1739.                                  BATCH FILES
  1740.  
  1741.  
  1742.           For EchoSprint to work effectively, the batch file controlling
  1743.           your front-end must be re-written to handle conditions set by
  1744.           both your mailer and now, EchoSprint.  This involves editing your
  1745.           "RUNBBS.BAT" batch file using your favourite text editor.
  1746.  
  1747.           6.1  Control batch file
  1748.  
  1749.           Load up your editor and load in the RUNBBS.BAT batch file (or the
  1750.           main batch file; you may not necessarily call it RUNBBS.BAT, but
  1751.           we'll refer to it as RUNBBS.BAT).  Editing this batch file
  1752.           requires handling new errorlevels passed from the mailer,
  1753.           creating a new label to run the EchoSprint software and finally,
  1754.           within the new label, handling errorlevels which may be passed
  1755.           from EchoSprint upon its exit.
  1756.  
  1757.           6.1.1  Answering and handshaking
  1758.  
  1759.           After your front-end receives its "EchoSprint" (or otherwise)
  1760.           external mail string, it will exit with the errorlevel we
  1761.           assigned the string in FrontDoor's configuration editor.
  1762.  
  1763.           Let's assume it was 150.  Find the section of your batch file
  1764.           where your mailer exits and checking is done for errorlevels for
  1765.           external events, mail being received and so on.  It would most
  1766.           likely look something like this if you are using FrontDoor.  Most
  1767.           mailers would be controlled in this fashion, however:
  1768.  
  1769.           /* RUNBBS.BAT */
  1770.  
  1771.           @Echo Off
  1772.  
  1773.           :Loop
  1774.  
  1775.           CD \FD
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.                                      - 33 -
  1784.  
  1785.           FD
  1786.  
  1787.           If Errorlevel 162 Goto Clean
  1788.           If Errorlevel 160 Goto Pack
  1789.           If Errorlevel 100 Goto MailReceived
  1790.           If Errorlevel  10 Goto UserBreak
  1791.           If Errorlevel   1 Goto FatalError
  1792.  
  1793.           Goto Loop
  1794.  
  1795.           :Pack
  1796.  
  1797.           CD \Squish
  1798.           Squish Out Squash
  1799.           Goto Loop
  1800.  
  1801.           :Clean
  1802.  
  1803.           CD \Squish
  1804.           SqPack \Max\Area.Dat
  1805.           Goto Loop
  1806.  
  1807.           :MailReceived
  1808.  
  1809.           CD \Squish
  1810.           Squish In Out Squash Link
  1811.           Goto Loop
  1812.  
  1813.           :UserBreak
  1814.  
  1815.           CD \
  1816.           Cls
  1817.           Goto Done
  1818.  
  1819.           :FatalError
  1820.  
  1821.           Cls
  1822.           Echo Fatal error occurred.
  1823.           Goto Done
  1824.  
  1825.           :Done
  1826.  
  1827.           /* End of file */
  1828.  
  1829.           You will need to add, between 162 and 100 (to keep the
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.                                      - 34 -
  1838.  
  1839.           errorlevels in DOS' compulsory descending order) a line:
  1840.  
  1841.           If Errorlevel  150 Goto ES_Inbound
  1842.  
  1843.           Assume the following errorlevels were set in the EchoSprint
  1844.           configuration editor:
  1845.  
  1846.           o  Session success     200
  1847.  
  1848.           o  Session denial      201
  1849.  
  1850.           o  Session failure     202
  1851.  
  1852.           o  Handshake failure   203
  1853.  
  1854.           o  No modem response   204
  1855.  
  1856.           You'll also need to add a label block between the Clean and
  1857.           MailReceived labels:
  1858.  
  1859.           :ES_Inbound
  1860.  
  1861.           CD \ES
  1862.           ES Answer
  1863.  
  1864.           If Errorlevel 204 Goto FatalError
  1865.           If Errorlevel 100 Goto MailReceived
  1866.           If Errorlevel   1 Goto FatalError
  1867.  
  1868.           Goto Loop
  1869.  
  1870.           (Errorlevels 200, 201, 202 and 203 need to loop back to the
  1871.           mailer anyway).
  1872.  
  1873.           This takes care of inbound calls.
  1874.  
  1875.           6.1.2  Polling
  1876.  
  1877.           To poll using an inactive event schedule, add some more lines
  1878.           after your mailer exits (we'll assume the external event to run
  1879.           EchoSprint sets an errorlevel of 164 and that EchoSprint's
  1880.           internal errorlevels are the same as above (200 through to 204).
  1881.  
  1882.           Add, after the mailer exits, between the line running "FD" and
  1883.           errorlevel 162 (to, again, keep the errorlevels in DOS'
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.                                      - 35 -
  1892.  
  1893.           compulsory descending order):
  1894.  
  1895.           If Errorlevel 164 Goto ES_EventA
  1896.  
  1897.           You'll now need to introduce a label between the Goto Loop line
  1898.           and the Pack label:
  1899.  
  1900.           :ES_EventA
  1901.  
  1902.           CD \ES
  1903.           ES Poll Event:A
  1904.  
  1905.           If Errorlevel 204 Goto FatalError
  1906.           If Errorlevel 100 Goto MailReceived
  1907.           If Errorlevel   1 Goto FatalError
  1908.  
  1909.           Goto Loop
  1910.  
  1911.           (Errorlevels 200, 201, 202 and 203 need to loop back to the mailer anyway).
  1912.  
  1913.           6.1.3  Handling errorlevels
  1914.  
  1915.           As mentioned previously, EchoSprint sets an errorlevel upon exit,
  1916.           based upon the status of the calls it has answered or made.
  1917.           These are, as also mentioned, defined within the configuration
  1918.           editor and should be trapped by your batch file to take action
  1919.           based on call status.
  1920.  
  1921.           The possible errorlevel states and recommended actions are listed
  1922.           below:
  1923.  
  1924.           o  Session success:    Return to the mailer.
  1925.  
  1926.           o  Session denial:     Return to the mailer.
  1927.  
  1928.           o  Session failure:    Return to the mailer.
  1929.  
  1930.           o  Handshake failure:  Return to the mailer.
  1931.  
  1932.           o  No modem response:  Terminate the batch file with a fatal
  1933.                                  error message.
  1934.  
  1935.           o  Mail received:      Process mail and return to the mailer.
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.                                      - 36 -
  1946.  
  1947.           6.1.4  Mail processing
  1948.  
  1949.           EchoSprint will exit with the mail received errorlevel as defined
  1950.           in FrontDoor's configuration file if it detects that a conference
  1951.           mail bundle which has been named following the ARCmail 0.60
  1952.           naming convention has arrived during the session.  The errorlevel
  1953.           will be extracted from the inactive event or, if this is set to
  1954.           0, the general mail received errorlevel will be set.
  1955.  
  1956.           If FrontDoor has been told to exit upon receipt of NetMail, then
  1957.           EchoSprint will set the mail received errorlevel if it detects
  1958.           that an FTS-0001 compliant NetMail packet has been received.
  1959.  
  1960.           If FrontDoor has been instructed to exit upon receipt of any
  1961.           file, EchoSprint will set the mail received errorlevel if it
  1962.           detects that any file has been received.
  1963.  
  1964.           After EchoSprint has been invoked in either Answer or Poll mode,
  1965.           if any of the above conditions are met (based entirely upon
  1966.           FrontDoor's configuration), EchoSprint will set the mail received
  1967.           errorlevel defined in FrontDoor's configuration.  You should trap
  1968.           this errorlevel and from it, run your conference mail processor
  1969.           to import the NetMail packets and/or conference mail bundles that
  1970.           EchoSprint has collected during the session.
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.                                      - 37 -
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.  
  2006.  
  2007.                                   Chapter 7
  2008.  
  2009.                                    SECURITY
  2010.  
  2011.  
  2012.           Since EchoSprint uses a proprietary handshake protocol (G2U), it
  2013.           has been refined to become one of the most high security sessions
  2014.           known in FidoNet technology networks.  As a brief summary of the
  2015.           security logic used (in case your security is lacking anywhere,
  2016.           resulting in handshake failures):
  2017.  
  2018.           o  The name of the remote Sysop must match the name listed for
  2019.              their node in the nodelist.
  2020.  
  2021.           o  The name of the remote system must match the system name
  2022.              listed for their node in the nodelist (it is not, however,
  2023.              case sensitive).
  2024.  
  2025.           o  All other site details (ie. phone number, location, and mailer
  2026.              flags) must match identically between the remote system's
  2027.              handshake packet and their details from the nodelist on your
  2028.              system.
  2029.  
  2030.           o  The address being called must match one of the AKAs presented
  2031.              to the calling system.
  2032.  
  2033.           o  Naturally, the presented "password" must match one of the
  2034.              configured external mail strings, or EchoSprint will not even
  2035.              be invoked by the answering mailer.
  2036.  
  2037.           7.1  Handshake security
  2038.  
  2039.           As mentioned numerously throughout this User's Guide, the
  2040.           external mail strings offer a large amount of elementary security
  2041.           to systems.  If, using EchoSprint for its main purpose, you
  2042.           configure your system for secure mail feeds with a number of
  2043.           different systems only, it might be a good idea to not assign the
  2044.           "EchoSprint" mail string and instead decide upon a private one to
  2045.           give to your feeding systems (either as a common password, or as
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.                                      - 38 -
  2054.  
  2055.           one each - if you have the space in your FrontDoor configuration to
  2056.           do so).
  2057.  
  2058.           Be sure, however, that if you are willing to accept polls from
  2059.           unarranged systems who will be attempting to use the "EchoSprint"
  2060.           string, that you define it, also.
  2061.  
  2062.           This is just a "high-level" entrance password - once through that
  2063.           stage of negotiation, the stricter G2U handshake must also be
  2064.           negotiated.
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                                      - 39 -
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.                                   Chapter 8
  2116.  
  2117.                             TECHNICAL SPECIFICATIONS
  2118.  
  2119.  
  2120.           8.1  Video operation
  2121.  
  2122.           As stated in the hardware requirements, EchoSprint will run on
  2123.           any IBM compatible display adapter.
  2124.  
  2125.           It does so by detecting the frame of video memory in use (whether
  2126.           it is colour or monochrome) and doing very fast direct memory
  2127.           access to that area of memory.
  2128.  
  2129.           If EchoSprint detects DESQview or a DESQview "simulator" upon
  2130.           initialising, it will instead write all screen output to the
  2131.           allocated DESQview video buffer.
  2132.  
  2133.           8.2  Memory requirements
  2134.  
  2135.           EchoSprint runs purely in conventional memory.  It is so small,
  2136.           that swaps to disk or expanded/extended memory are not required
  2137.           when shelling to other applications.
  2138.  
  2139.           EchoSprint requires approximately 75KB of conventional memory to
  2140.           run.  It has been run successfully under DESQview using a memory
  2141.           size of only 88KB (this figure includes a copy of the shell that
  2142.           EchoSprint is run in).
  2143.  
  2144.           Naturally, to allow for the running of external protocols and so
  2145.           on, more RAM must be allocated, but if EchoSprint is running
  2146.           under a much larger mailer, the RAM will already be allocated to
  2147.           do so.
  2148.  
  2149.           With regard to disk space requirements, EchoSprint in its
  2150.           entirety (including the documentation, final release notes,
  2151.           configuration file, template file and the executable) occupies
  2152.           approximately 140KB of disk space.
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.                                      - 40 -
  2162.  
  2163.           The nodelist indexes (created by the EchoSprint nodelist compiler
  2164.           in the FrontDoor nodelist directory) are phenomenally small.  For
  2165.           this week's FidoNet nodelist (approximately 1450KB in size), the
  2166.           corresponding index files are:
  2167.  
  2168.           INDEX    ES         30 17-07-92   5:04a
  2169.           NETS     ES       3468 17-07-92   5:04a
  2170.           ZONES    ES         84 17-07-92   5:04a
  2171.                   3 file(s)       3582 bytes
  2172.  
  2173.           So, given the potential for a growing nodelist and the smaller
  2174.           nodelists belonging to alternate networks, the indexes are
  2175.           unlikely to exceed 8KB in the near future.
  2176.  
  2177.           8.2  G2U handshaking
  2178.  
  2179.           The proprietary "G'day to you!" handshake has been modelled from
  2180.           the EMSI handshake protocol used in common day mail systems.
  2181.  
  2182.           The differences are that it has been optimised to send only vital
  2183.           data in the handshake packets.  It has been noticed than for many
  2184.           long haul mail sessions, the majority of the session time is
  2185.           spent in session negotiation.  Furthermore, it is a three-way
  2186.           protocol, whereby the list of requested files is sent in the
  2187.           packet.  In the third pass of the handshake, the remote returns
  2188.           the total size of those files, so that both ends know exactly how
  2189.           long the session will take at the outset, and which files will be
  2190.           transferred.
  2191.  
  2192.           8.4  File access
  2193.  
  2194.           EchoSprint locks and shares files as necessary under
  2195.           multitaskers and local area networks.  The evaluation version of
  2196.           EchoSprint does not support file sharing (even if it has been
  2197.           chosen in the configuration editor).
  2198.  
  2199.           Normally, however, all files are accessed using file sharing, but
  2200.           does not require SHARE.EXE to be loaded.
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.                                      - 41 -
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.                                   Chapter 9
  2224.  
  2225.                                ALTERNATE MAILERS
  2226.  
  2227.  
  2228.           To users who do not normally use FrontDoor as their front-end,
  2229.           this chapter will be of paramount importance.  Since the number
  2230.           of MS-DOS based FidoNet compatible mailers is so large, it has
  2231.           been difficult to obtain information regarding the compatibility
  2232.           of EchoSprint with them.  As mentioned above, the following
  2233.           mailers have been tested with EchoSprint:
  2234.  
  2235.           o  FrontDoor 2.02/non-commercial
  2236.  
  2237.           o  FrontDoor 2.10/commercial
  2238.  
  2239.           o  InterMail
  2240.  
  2241.           o  D'Bridge 1.30
  2242.  
  2243.           o  BinkleyTerm 2.56wb
  2244.  
  2245.           There are undoubtedly countless other mailers which will work
  2246.           with EchoSprint, on the following provisions:
  2247.  
  2248.           o  That you actually obtain FrontDoor 2.01 or greater and install
  2249.              the configuration files.
  2250.  
  2251.           o  That, given an "external mail string", your current mailer can
  2252.              exit to its calling batch file with a set errorlevel.
  2253.  
  2254.           o  That your current mailer allows DOS errorlevel exits from the
  2255.              mailer through elapsed events.
  2256.  
  2257.           o  That your mail processor queues outbound mail using file
  2258.              attach messages.  If it does not (and instead builds flow
  2259.              files), a number of utilities can make the conversion(s) for
  2260.              you.
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.                                      - 42 -
  2270.  
  2271.           If these can all be satisfied, then you may use EchoSprint with
  2272.           your current mailer.
  2273.  
  2274.           FrontDoor must be obtained and decompressed into a directory
  2275.           (which you have pointed to using an FD environment variable).  If
  2276.           you have not already done so, add the FD environment variable
  2277.           using the same procedure as outlined in section 2.3.
  2278.  
  2279.           Once your FrontDoor files are in this directory, you may safely
  2280.           remove all files except for FD.DOC (which you are likely to
  2281.           need), FDSETUP.EXE (which will be required to configure
  2282.           FrontDoor), ROUTE.FD and FDNODE.CTL.
  2283.  
  2284.           Read through the FrontDoor documentation as you work through the
  2285.           FrontDoor configuration editor.  Many of the items may be left on
  2286.           their default values.
  2287.  
  2288.           The configuration items to concentrate on are:
  2289.  
  2290.           o  Global
  2291.  
  2292.           o  Mailer
  2293.  
  2294.           o  Modem
  2295.  
  2296.           o  Manager
  2297.  
  2298.           This should only require fifteen or so minutes to complete.  The
  2299.           file ROUTE.FD must be edited using your favourite text editor to
  2300.           contain the EchoSprint verbs mentioned in section 3.2.3.2.
  2301.  
  2302.           Finally, the FDNODE.CTL file should also be modified to implement
  2303.           cost control and dialling translations.  The format of this text
  2304.           file should be familiar to users of other nodelist compilers such
  2305.           as XlaxNode or SysNL.
  2306.  
  2307.           This file must be placed in the directory specified in the
  2308.           FrontDoor configuration editor as being the nodelist directory.
  2309.           Check which path you have set:
  2310.  
  2311.           >  Global > Filenames > Nodelist
  2312.  
  2313.           This will also be the directory where the EchoSprint nodelist
  2314.           indexes will be placed.
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.                                      - 43 -
  2324.  
  2325.           With the above in mind, it should be relatively easy to install
  2326.           FrontDoor for the first time (if you are familiar with network
  2327.           operations, you can install just about any mailer easily).  Other
  2328.           mailers which are suspected to be compatible with EchoSprint
  2329.           are:
  2330.  
  2331.           o  Dutchie 2.90c
  2332.  
  2333.           o  SEAdog
  2334.  
  2335.           o  Opus 1.03c or greater
  2336.  
  2337.           o  TIMS
  2338.  
  2339.           Any difficulties in integrating any mailer into operation with
  2340.           EchoSprint should be directed to the authors.  See Appendix D for
  2341.           further details.
  2342.  
  2343.           If EchoSprint has been successfully installed with your mailer
  2344.           (which is not FrontDoor, BinkleyTerm, InterMail or D'Bridge),
  2345.           please contact the authors so that they may make this information
  2346.           available to the EchoSprint support sites.  Please include any
  2347.           information which may prove useful to other users of your
  2348.           front-end mailer.
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.                                      - 44 -
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.                                   Chapter 10
  2386.  
  2387.                        RECOMMENDED ACCOMPANYING SOFTWARE
  2388.  
  2389.  
  2390.           It would be unfair fair to make "recommendations" on software as
  2391.           such, but this chapter will be devoted to illustrating which
  2392.           software packages are successfully being used on the systems
  2393.           maintained by the authors.
  2394.  
  2395.  
  2396.           /* 3:620/262 */
  2397.  
  2398.           o  FrontDoor 2.02/non-commercial
  2399.           o  EchoSprint 1.01
  2400.           o  Squish 1.01
  2401.           o  Maximus-CBCS 2.01wb
  2402.           o  XRobot 2.40
  2403.           o  FEcho 0.94
  2404.  
  2405.  
  2406.           /* 3:620/247.5 */
  2407.  
  2408.           o  BinkleyTerm/2 2.56wb
  2409.           o  EchoSprint 1.01
  2410.           o  FMail 0.90
  2411.           o  GoldEd 2.40
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.                                      - 45 -
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.                                   Appendix A
  2441.  
  2442.                                 FOSSIL drivers
  2443.  
  2444.  
  2445.           EchoSprint has been tested using the two most common FOSSIL
  2446.           drivers available today: Ray Gwinn's X00 and David Nugent's Basic
  2447.           Network Utility (BNU).  Both of these drivers have given
  2448.           excellent performance using various low-speed and high-speed
  2449.           modems.
  2450.  
  2451.           As a general rule, if your mailer can do file transfers at an
  2452.           optimum speed using its in-built transfer protocols, you should
  2453.           expect to see similar performance with EchoSprint.  The only
  2454.           consideration is that, given the vast number of protocols that
  2455.           can be used in conjunction with EchoSprint, they must be
  2456.           configured correctly themselves, if they use the FOSSIL.  Refer
  2457.           to the documentation for any protocols you use for further
  2458.           information.
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.                                      - 46 -
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.                                   Appendix B
  2494.  
  2495.                               Example batch files
  2496.  
  2497.  
  2498.           Several batch file examples are provided here to assist in the
  2499.           integration of EchoSprint with your current mailer.  Our
  2500.           experience has been limited to FrontDoor and BinkleyTerm, so
  2501.           these examples will be based on those, however other mailers
  2502.           should be very similar in operation (for example, InterMail
  2503.           users will find the FrontDoor batch files very close to
  2504.           correct):s
  2505.  
  2506.           For FrontDoor users:
  2507.  
  2508.           /* RUNFD.BAT */
  2509.  
  2510.           @Echo Off
  2511.  
  2512.           :Loop
  2513.  
  2514.           CD \FD
  2515.           FD
  2516.  
  2517.           If Errorlevel 164 Goto ES_EventA
  2518.           If Errorlevel 162 Goto Clean
  2519.           If Errorlevel 160 Goto Pack
  2520.           If Errorlevel 150 Goto ES_Inbound
  2521.           If Errorlevel 100 Goto MailReceived
  2522.           If Errorlevel  10 Goto UserBreak
  2523.           If Errorlevel   1 Goto FatalError
  2524.  
  2525.           :ES_EventA
  2526.  
  2527.           CD \ES
  2528.           ES Poll Event:A
  2529.  
  2530.           If Errorlevel 204 Goto FatalError
  2531.           If Errorlevel 100 Goto MailReceived
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.                                      - 47 -
  2540.  
  2541.           If Errorlevel   1 Goto FatalError
  2542.  
  2543.           Goto Loop
  2544.  
  2545.           :Pack
  2546.  
  2547.           CD \Squish
  2548.           Squish Out Squash
  2549.           Goto Loop
  2550.  
  2551.           :ES_Inbound
  2552.  
  2553.           CD \ES
  2554.           ES Answer
  2555.  
  2556.           If Errorlevel 204 Goto FatalError
  2557.           If Errorlevel 100 Goto MailReceived
  2558.           If Errorlevel   1 Goto FatalError
  2559.  
  2560.           Goto Loop
  2561.  
  2562.           :Clean
  2563.  
  2564.           CD \Squish
  2565.           SqPack \Max\Area.Dat
  2566.           Goto Loop
  2567.  
  2568.           :MailReceived
  2569.  
  2570.           CD \Squish
  2571.           Squish In Out Squash Link
  2572.           Goto Loop
  2573.  
  2574.           :UserBreak
  2575.  
  2576.           CD \
  2577.           Cls
  2578.           Goto Done
  2579.  
  2580.           :FatalError
  2581.  
  2582.           Cls
  2583.           Echo Fatal error occurred.
  2584.           Goto Done
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.                                      - 48 -
  2594.  
  2595.           :Done
  2596.  
  2597.           /* End of file */
  2598.  
  2599.  
  2600.           For BinkleyTerm users:
  2601.  
  2602.           /* RUNBINK.BAT */
  2603.  
  2604.           @Echo Off
  2605.  
  2606.           :Loop
  2607.  
  2608.           CD \BT
  2609.           BT Unattended
  2610.  
  2611.           If Errorlevel 255 Goto FatalError
  2612.           If Errorlevel 164 Goto ES_EventA
  2613.           If Errorlevel 162 Goto Clean
  2614.           If Errorlevel 160 Goto Pack
  2615.           If Errorlevel 150 Goto ES_Inbound
  2616.           If Errorlevel 100 Goto MailReceived
  2617.           If Errorlevel   1 Goto UserBreak
  2618.  
  2619.           Goto Loop
  2620.  
  2621.           :ES_EventA
  2622.  
  2623.           CD \ES
  2624.           ES Poll Event:A
  2625.  
  2626.           If Errorlevel 204 Goto FatalError
  2627.           If Errorlevel 100 Goto MailReceived
  2628.           If Errorlevel   1 Goto FatalError
  2629.  
  2630.           Goto Loop
  2631.  
  2632.           :Pack
  2633.  
  2634.           CD \Squish
  2635.           Squish Out Squash
  2636.           Goto Loop
  2637.  
  2638.           :ES_Inbound
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.                                      - 49 -
  2648.  
  2649.           CD \ES
  2650.           ES Answer
  2651.  
  2652.           If Errorlevel 204 Goto FatalError
  2653.           If Errorlevel 100 Goto MailReceived
  2654.           If Errorlevel   1 Goto FatalError
  2655.  
  2656.           Goto Loop
  2657.  
  2658.           :Clean
  2659.  
  2660.           CD \Squish
  2661.           SqPack \Max\Area.Dat
  2662.           Goto Loop
  2663.  
  2664.           :MailReceived
  2665.  
  2666.           CD \Squish
  2667.           Squish In Out Squash Link
  2668.           Goto Loop
  2669.  
  2670.           :UserBreak
  2671.  
  2672.           CD \
  2673.           Cls
  2674.           Goto Done
  2675.  
  2676.           :FatalError
  2677.  
  2678.           Cls
  2679.           Echo Fatal error occurred.
  2680.           Goto Done
  2681.  
  2682.           :Done
  2683.  
  2684.           /* End of file */
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.                                      - 50 -
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.                                   Appendix C
  2710.  
  2711.                         Evaluation version of EchoSprint
  2712.  
  2713.  
  2714.           An evaluation version of EchoSprint has been distributed
  2715.           world-wide for general evaluation prior to licencing the
  2716.           package.
  2717.  
  2718.           The evaluation version is only inhibited in that neither of the
  2719.           two mailer operations (Poll and Answer) will operate.  All of the
  2720.           utility operations will work, the package may be configured in
  2721.           full, and the entire User's Guide is included for your
  2722.           inspection.
  2723.  
  2724.           Please view the file ORDER.FRM in the distribution archive of the
  2725.           evaluation version for details on licencing this product.
  2726.  
  2727.           The evaluation copy has been distributed world-wide as
  2728.           ES_101D.EXE.  It is compressed using the ARJ archival utility and
  2729.           is self-extracting.  This archive must be distributed in this
  2730.           form - do not compress it into a different archiving format.
  2731.  
  2732.           The actual package title is EchoSprint 1.01/demo.
  2733.  
  2734.           The archive (ES_101D.EXE) is available from the following
  2735.           sources:
  2736.  
  2737.           o  Anonymous FTP from SIMTEL-20 and associated mirror sites on
  2738.              the Internet (in the ../fido directory).
  2739.  
  2740.           o  File request from 3:620/262@fidonet.org (OCS Lab) as ESDEMO or
  2741.              ES_101D.EXE.  This is available 24 hours a day, from 2400 baud
  2742.              to 14,400 baud (V.32bis).
  2743.  
  2744.           o  ES_101D.EXE has been hatched into the SDS SOFTDIST file echo
  2745.              and may be available from any SDS collection site.
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.                                      - 51 -
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.                                   Appendix D
  2764.  
  2765.                                 Product support
  2766.  
  2767.  
  2768.           The authors of EchoSprint may be contacted via FidoNet NetMail
  2769.           and EchoMail.
  2770.  
  2771.           Via NetMail (or e-mail), the authors may be reached at:
  2772.  
  2773.           3:620/262@fidonet.org            (To: Ben Elliston)
  2774.           3:620/247.5@fidonet.org          (To: Mark Hulskamp)
  2775.           tp923021@jarrah.canberra.edu.au  (Internet e-mail)
  2776.  
  2777.           Via postal mail:
  2778.  
  2779.             Compact Solutions
  2780.             180 Drake Brockman Drive
  2781.             Holt ACT 2615
  2782.             Australia
  2783.  
  2784.           Urgent matters may be directed to 3:620/262 as crash mail, since
  2785.           that node runs as continuous mail.
  2786.  
  2787.           An EchoSprint support conference exists and is read and moderated
  2788.           by both the authors.  It originates from OCS Lab (3:620/262), but
  2789.           is gradually becoming available elsewhere.  Check with your local
  2790.           network coordinator and regional coordinator regarding its
  2791.           availability.
  2792.  
  2793.           The conference is intended to be international and for Sysop-only
  2794.           access.  The EchoMail area tag is "ECHOSPRINT".
  2795.  
  2796.           If the conference is not available locally, it may be obtained
  2797.           somewhere more distant, or if necessary, contact the Sysop of
  2798.           3:620/262 for details on collecting it from there (up to
  2799.           V.32bis).  Provide your node number, a session level password
  2800.           of your choice and the compression method of your choice if you
  2801.           wish to poll for the conference from 3:620/262.
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.                                      - 52 -
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.                                   Appendix E
  2818.  
  2819.                                 Troubleshooting
  2820.  
  2821.  
  2822.           This appendix lists some of the most frequently asked questions
  2823.           about EchoSprint, and the answers to them.  Hopefully it will
  2824.           resolve some of your initial problems before having to turn to
  2825.           the support sites for assistance.
  2826.  
  2827.           Q:  In the configuration editor, the shelling keys (<F2> and
  2828.               <F3>) do not work.  Why?
  2829.  
  2830.           A:  EchoSprint should report "Insufficient memory" in this
  2831.               situation, but often the amount of RAM to load the command
  2832.               interpreter will be available, but not enough to fully load
  2833.               the program (such as COMMAND.COM and FDSETUP.EXE).  The
  2834.               command interpreter will quickly flash "Not enough memory".
  2835.               Increase the memory available to EchoSprint and try again.
  2836.  
  2837.           Q:  EchoSprint is reporting errors concerning the structures of
  2838.               SETUP.FD and/or SETUP.ES.  What is going on?
  2839.  
  2840.           A:  EchoSprint safeguards against corrupt configuration files.
  2841.               The structure error will appear when:
  2842.  
  2843.               o  By attempting to open a FrontDoor configuration file
  2844.                  generated by FrontDoor 2.00 or less (ie. 1.99c).
  2845.  
  2846.               o  By attempting to open an EchoSprint configuration file
  2847.                  which has been corrupted.
  2848.  
  2849.           Q:  When compiling the nodelist, for example, I see "Error
  2850.               opening nodelist".  The file exists, but EchoSprint can't
  2851.               open it .. why?
  2852.  
  2853.           A:  If you are running under a multitasker, and FrontDoor is
  2854.               running in another task, it will have locks on the nodelist
  2855.               files.  The licenced version supports file sharing so that
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.                                      - 53 -
  2864.  
  2865.               this problem may be avoided, but in the evaluation version,
  2866.               FrontDoor must be unloaded before compiling your nodelists.
  2867.  
  2868.           Q:  What could possibly cause the "session denial" errorlevel to
  2869.               be issued?
  2870.  
  2871.           A:  Although not documented, the FrontDoor routing verb "DENY"
  2872.               will also be respected by EchoSprint.  If, during the current
  2873.               event, a system is denied using this verb, EchoSprint will
  2874.               also disallow it to connect, yielding the "session denial"
  2875.               errorlevel.
  2876.  
  2877.           Q:  What is meant by the "Uh oh" error message?
  2878.  
  2879.           A:  Basically, this means that EchoSprint had to terminate
  2880.               unexpectedly.  If EchoSprint could gain access to your
  2881.               FrontDoor log file, it will write the error condition and
  2882.               important information for the authors to the log file.
  2883.               Please report these fatal errors (see Appendix D) to the
  2884.               authors and when doing so, please quote the error number and
  2885.               the address at which the error occurred.
  2886.  
  2887.           Q:  What about OS/2?
  2888.  
  2889.           A:  EchoSprint should run fine under OS/2.  If it gives you some
  2890.               trouble, obtain a copy of version 1.49 of the X00 FOSSIL.
  2891.               Borland International are now beginning to support OS/2, and
  2892.               when Turbo Pascal for OS/2 arrives, we will no doubt code a
  2893.               multithreaded OS/2 version as well.
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.                                      - 54 -
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.                                   Appendix F
  2926.  
  2927.                              Package authenticity
  2928.  
  2929.  
  2930.           Quoting figures such as cyclic redundancy checks and file sizes
  2931.           in this freely distributable document is a very poor method for
  2932.           authenticity checking on executable files.  Being publicly
  2933.           accessible, it is just too easy for someone to incorporate
  2934.           trojan horses into the executable and tamper with the figures
  2935.           quoted in the documentation such that the package will look
  2936.           authentic.
  2937.  
  2938.           It is suggested that files be scanned using a virus protection
  2939.           utility such as McAfee's ViruScan before use, however, should you
  2940.           be concerned about the authenticity of your package, send a
  2941.           NetMail message to the Sysop of 3:620/247.5 requesting the output
  2942.           of the McAfee Validate utility and file sizes.
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.                                      - 55 -
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.                                   Appendix G
  2980.  
  2981.                               Credits and thanks
  2982.  
  2983.  
  2984.           Products mentioned in this User's Guide are trademarks of their
  2985.           holders:
  2986.  
  2987.           ARJ                             Robert K. Jung
  2988.           BiModem                         Erik Labs
  2989.           BinkleyTerm                     Bit Bucket Software
  2990.           BNU                             David Nugent and Unique Computing
  2991.           D'Bridge                        Chris Irwin
  2992.           DESQview                        Quarterdeck Office Systems
  2993.           DSZ                             Omen Technology
  2994.           Dutchie                         Henk Wevers
  2995.           FEcho                           W. K. F. van der Windt
  2996.           FMail                           Folkert J. Wijnstra
  2997.           FrontDoor                       Advanced Engineering sarl
  2998.           GoldEd                          Odinn Sorensen
  2999.           HyperDisk                       Roger Cross
  3000.           HS/Link                         Samuel H. Smith
  3001.           InterMail                       InterZone Software
  3002.           Maximus-CBCS                    Scott J. Dudley
  3003.           Microsoft Windows               Microsoft Corporation
  3004.           MS-DOS                          Microsoft Corporation
  3005.           Novell NetWare                  Novell, Inc.
  3006.           Opus                            Wynn Wagner III
  3007.           OS/2                            International Business Machines
  3008.           PKLite                          PKWare, Inc.
  3009.           SEAdog                          System Enhancement Associates
  3010.           SMARTdrive                      Microsoft Corporation
  3011.           Squish                          Scott J. Dudley
  3012.           SuperZmodem                     Scott M. Baker
  3013.           TIMS                            Bit Bucket Software
  3014.           X00                             Raymond L. Gwinn
  3015.           XRobot                          Joaquim H. Homrighausen
  3016.  
  3017.           Thanks must go to Rafy Marootians for his help in beta testing
  3018.           this package.  Rafy uses programs the way they weren't designed
  3019.           to be!
  3020.  
  3021.           Many thanks to Jason Hecker for the EchoSprint logo.  Even if he
  3022.           did draw it on an Amiga. :-)
  3023.  
  3024.  
  3025.                                      - 56 -
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.                                   Glossary
  3034.  
  3035.  
  3036.           AKA
  3037.  
  3038.           "Also Known As".  When two mailers handshake, they are now able
  3039.           to exchange their additional network addresses and exchange mail
  3040.           for those systems in the same session.
  3041.  
  3042.  
  3043.           ARCmail
  3044.  
  3045.           Refers to the naming convention for files originally defined by
  3046.           Thom Henderson.  EchoSprint supports the 0.60 revision of the
  3047.           ARCmail convention which is approved by the FTSC.
  3048.  
  3049.           FOSSIL
  3050.  
  3051.           Fido/Opus/SEAdog Standard Interface Layer.  This standardised
  3052.           communications driver allows software to interface with a large
  3053.           range of hardware.  To use a hardware item with a FOSSIL driven
  3054.           communications program, the user only requires a FOSSIL which
  3055.           supports that hardware.  From then on, all FOSSIL based
  3056.           communications software will access the hardware through the
  3057.           FOSSIL and therefore be compatible with it.
  3058.  
  3059.  
  3060.           FTSC
  3061.  
  3062.           FidoNet Technical Standards Committee.
  3063.  
  3064.  
  3065.           FTP
  3066.  
  3067.           File Transfer Protocol.  A means of transferring files between
  3068.           two Unix machines across the world-wide Internet.
  3069.  
  3070.  
  3071.           G2U
  3072.  
  3073.           Compact Solutions' proprietary session level protocol.  G2U is a
  3074.           variant of the EMSI handshaking protocol, but improves on its
  3075.           shortcomings.  G2U stands for "G'day to you!", as a tribute to
  3076.           our Australian culture.
  3077.  
  3078.  
  3079.                                      - 57 -
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.                                    Contents
  3088.  
  3089.  
  3090.           Chapter 1  PREFACE  . . . . . . . . . . . . . . . . . . . . . . 2
  3091.              1.1  Introduction  . . . . . . . . . . . . . . . . . . . . . 2
  3092.              1.2  Features  . . . . . . . . . . . . . . . . . . . . . . . 2
  3093.              1.3  Using this User's Guide . . . . . . . . . . . . . . . . 4
  3094.              1.4  Licence agreement . . . . . . . . . . . . . . . . . . . 4
  3095.  
  3096.           Chapter 2  INSTALLATION . . . . . . . . . . . . . . . . . . . . 6
  3097.              2.1  Hardware and software requirements  . . . . . . . . . . 6
  3098.              2.2  Operating system files  . . . . . . . . . . . . . . . . 7
  3099.              2.3  Environment variables . . . . . . . . . . . . . . . . . 8
  3100.              2.4  The distribution archive  . . . . . . . . . . . . . . . 8
  3101.              2.5  Directories . . . . . . . . . . . . . . . . . . . . . . 9
  3102.              2.6  EchoSprint files  . . . . . . . . . . . . . . . . . . . 9
  3103.                 2.6.1  Executable files . . . . . . . . . . . . . . . .   9
  3104.                 2.6.2  Documentation files  . . . . . . . . . . . . . .   9
  3105.                 2.6.3  Configuration files  . . . . . . . . . . . . . .  10
  3106.              2.7  Protocols . . . . . . . . . . . . . . . . . . . . . .  10
  3107.              2.8  Networks and multitasking . . . . . . . . . . . . . .  10
  3108.  
  3109.           Chapter 3  CONFIGURATION  . . . . . . . . . . . . . . . . . .  12
  3110.              3.1  The configuration editor  . . . . . . . . . . . . . .  12
  3111.                 3.1.1  Navigating the configuration editor  . . . . . .  12
  3112.                 3.1.2  File sharing . . . . . . . . . . . . . . . . . .  13
  3113.                 3.1.3  Errorlevels  . . . . . . . . . . . . . . . . . .  13
  3114.                    3.1.3.1  Session success . . . . . . . . . . . . . .  13
  3115.                    3.1.3.2  Session denial  . . . . . . . . . . . . . .  14
  3116.                    3.1.3.3  Session failure . . . . . . . . . . . . . .  14
  3117.                    3.1.3.4  Handshake failure . . . . . . . . . . . . .  14
  3118.                    3.1.3.5  No modem response . . . . . . . . . . . . .  14
  3119.                 3.1.4  File requests  . . . . . . . . . . . . . . . . .  14
  3120.                 3.1.5  Nodelists  . . . . . . . . . . . . . . . . . . .  15
  3121.              3.2  FrontDoor configuration . . . . . . . . . . . . . . .  15
  3122.                 3.2.1  Configuration requirements . . . . . . . . . . .  15
  3123.                 3.2.2  External mail strings  . . . . . . . . . . . . .  16
  3124.                 3.2.3  Events . . . . . . . . . . . . . . . . . . . . .  16
  3125.                    3.2.3.1  Event configuration and entry . . . . . . .  16
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.                                       - i -
  3134.  
  3135.                    3.2.3.2  Schedule tags/mail routing  . . . . . . . .  17
  3136.                    3.2.3.3  Event behaviour . . . . . . . . . . . . . .  19
  3137.                    3.2.3.4  Global answering event  . . . . . . . . . .  19
  3138.                 3.2.4  File requests  . . . . . . . . . . . . . . . . .  20
  3139.                    3.2.4.1  Alias names . . . . . . . . . . . . . . . .  20
  3140.                    3.2.4.2  Update requests . . . . . . . . . . . . . .  20
  3141.                    3.2.4.3  Requestable directories . . . . . . . . . .  20
  3142.                    3.2.4.4  Service/server requests . . . . . . . . . .  21
  3143.                    3.2.4.5  File request failures . . . . . . . . . . .  21
  3144.                       3.2.4.5.1  BinkleyTerm style (template) . . . . .  21
  3145.                       3.2.4.5.2  FrontDoor style (message)  . . . . . .  24
  3146.              3.3  Nodelists . . . . . . . . . . . . . . . . . . . . . .  24
  3147.                 3.3.1  Compiling nodelists  . . . . . . . . . . . . . .  24
  3148.  
  3149.           Chapter 4  ECHOSPRINT . . . . . . . . . . . . . . . . . . . .  25
  3150.              4.1  The executable  . . . . . . . . . . . . . . . . . . .  25
  3151.              4.2  Command line parameters . . . . . . . . . . . . . . .  25
  3152.                 4.2.1  Poll . . . . . . . . . . . . . . . . . . . . . .  26
  3153.                 4.2.2  Answer . . . . . . . . . . . . . . . . . . . . .  26
  3154.                 4.2.3  Configure  . . . . . . . . . . . . . . . . . . .  26
  3155.                 4.2.4  Compile  . . . . . . . . . . . . . . . . . . . .  27
  3156.                 4.2.5  Template . . . . . . . . . . . . . . . . . . . .  27
  3157.                 4.2.6  Password . . . . . . . . . . . . . . . . . . . .  27
  3158.                 4.2.7  Event  . . . . . . . . . . . . . . . . . . . . .  28
  3159.                 4.2.8  Manual . . . . . . . . . . . . . . . . . . . . .  28
  3160.  
  3161.           Chapter 5  OPERATIONAL OVERVIEW . . . . . . . . . . . . . . .  30
  3162.              5.1  Handshaking . . . . . . . . . . . . . . . . . . . . .  30
  3163.              5.2  Sessions  . . . . . . . . . . . . . . . . . . . . . .  30
  3164.                 5.2.1  Polls  . . . . . . . . . . . . . . . . . . . . .  30
  3165.                 5.2.2  Inbound sessions . . . . . . . . . . . . . . . .  30
  3166.              5.3  File transfers  . . . . . . . . . . . . . . . . . . .  31
  3167.              5.4  File requests . . . . . . . . . . . . . . . . . . . .  31
  3168.              5.5  Log file  . . . . . . . . . . . . . . . . . . . . . .  31
  3169.              5.6  Miscellaneous . . . . . . . . . . . . . . . . . . . .  32
  3170.  
  3171.           Chapter 6  BATCH FILES  . . . . . . . . . . . . . . . . . . .  33
  3172.              6.1  Control batch file  . . . . . . . . . . . . . . . . .  33
  3173.                 6.1.1  Answering and handshaking  . . . . . . . . . . .  33
  3174.                 6.1.2  Polling  . . . . . . . . . . . . . . . . . . . .  35
  3175.                 6.1.3  Handling errorlevels . . . . . . . . . . . . . .  36
  3176.                 6.1.4  Mail processing  . . . . . . . . . . . . . . . .  37
  3177.  
  3178.           Chapter 7  SECURITY . . . . . . . . . . . . . . . . . . . . .  38
  3179.              7.1  Handshaking security  . . . . . . . . . . . . . . . .  38
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.                                      - ii -
  3188.  
  3189.           Chapter 8  TECHNICAL SPECIFICATIONS . . . . . . . . . . . . .  40
  3190.              8.1  Video operation . . . . . . . . . . . . . . . . . . .  40
  3191.              8.2  Memory requirements . . . . . . . . . . . . . . . . .  40
  3192.              8.3  G2U handshaking . . . . . . . . . . . . . . . . . . .  41
  3193.              8.4  File access . . . . . . . . . . . . . . . . . . . . .  41
  3194.  
  3195.           Chapter 9  ALTERNATE MAILERS  . . . . . . . . . . . . . . . .  42
  3196.  
  3197.           Chapter 10  RECOMMENDED ACCOMPANYING SOFTWARE . . . . . . . .  45
  3198.  
  3199.           Appendix A  FOSSIL drivers  . . . . . . . . . . . . . . . . .  46
  3200.  
  3201.           Appendix B  Example batch files . . . . . . . . . . . . . . .  47
  3202.  
  3203.           Appendix C  Evaluation version of EchoSprint  . . . . . . . .  51
  3204.  
  3205.           Appendix D  Product support . . . . . . . . . . . . . . . . .  52
  3206.  
  3207.           Appendix E  Troubleshooting . . . . . . . . . . . . . . . . .  53
  3208.  
  3209.           Appendix F  Package authenticity  . . . . . . . . . . . . . .  55
  3210.  
  3211.           Appendix G  Credits and thanks  . . . . . . . . . . . . . . .  56
  3212.  
  3213.           Glossary  . . . . . . . . . . . . . . . . . . . . . . . . . .  57
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.                                      - iii -
  3242.